<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>/package/devices element</title>
<title>CMSIS-Pack: /package/devices element</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="cmsis.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/javascript" src="printComponentTabs.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
  $(window).load(resizeHeight);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 46px;">
  <td id="projectlogo"><img alt="Logo" src="CMSIS_Logo_Final.png"/></td>
  <td style="padding-left: 0.5em;">
   <div id="projectname">CMSIS-Pack
   &#160;<span id="projectnumber">Version 1.6.0</span>
   </div>
   <div id="projectbrief">Delivery Mechanism for Software Packs</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<div id="CMSISnav" class="tabs1">
    <ul class="tablist">
      <script type="text/javascript">
		<!--
		writeComponentTabs.call(this);
		//-->
      </script>
	  </ul>
</div>
<!-- Generated by Doxygen 1.8.6 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li class="current"><a href="pages.html"><span>Usage&#160;and&#160;Description</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('pdsc_devices_pg.html','');});
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Pages</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
  <div class="headertitle">
<div class="title">/package/devices element </div>  </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>The level <b>&lt;devices&gt;</b> contains all devices for which support is provided by the <a class="el" href="cp_SWComponents.html">Software Pack</a>.</p>
<p>Devices can be organized in hierarchy groups to limit redundancy. The hierarchy levels are:</p>
<ul>
<li><a class="el" href="pdsc_family_pg.html#element_family">family</a>: the attributes of a device family which includes also the processor.</li>
<li><a class="el" href="pdsc_family_pg.html#element_subFamily">subFamily</a>: attributes of an optional sub-family; this adds or modifies features of a family.</li>
</ul>
<p>Device characteristics can be defined in:</p>
<ul>
<li><a class="el" href="pdsc_family_pg.html#element_device">device</a>: attributes of a specific silicon device</li>
<li><a class="el" href="pdsc_family_pg.html#element_variant">variant</a>: attributes of a device variant (for example, with different package or temperature range) or an OEM device or board that integrates the device.</li>
</ul>
<p>A device is described by the following properties:</p>
<ul>
<li><a class="el" href="pdsc_family_pg.html#element_description">description</a>: textual device description</li>
<li><a class="el" href="pdsc_family_pg.html#element_feature">feature</a>: categorized list of device peripherals and features</li>
<li><a class="el" href="pdsc_family_pg.html#element_book">book</a>: documentation about the device and its processor(s)</li>
<li><a class="el" href="pdsc_family_pg.html#element_processor">processor</a>: processor and processor features embedded in the device</li>
<li><a class="el" href="pdsc_family_pg.html#element_compile">compile</a>: device specific general settings for the build tools</li>
<li><a class="el" href="pdsc_family_pg.html#element_debugconfig">debugconfig</a>: default settings for a debug connection</li>
<li><a class="el" href="pdsc_family_pg.html#element_debugvars">debugvars</a>: global debug access variables for use in sequences.</li>
<li><a class="el" href="pdsc_family_pg.html#element_sequences">sequences</a>: debug access sequences.</li>
<li><a class="el" href="pdsc_family_pg.html#element_debugport">debugport</a>: debug port description of the device for the debugger to configure a debug connection.</li>
<li><a class="el" href="pdsc_family_pg.html#element_debug">debug</a>: device specific information for the debugger to configure a debug connection including System View Description files.</li>
<li><a class="el" href="pdsc_family_pg.html#element_trace">trace</a>: device specific information for the debugger to configure trace.</li>
<li><a class="el" href="pdsc_family_pg.html#element_memory">memory</a>: memory layout of the device for internal and external RAM and ROM regions</li>
<li><a class="el" href="pdsc_family_pg.html#element_algorithm">algorithm</a>: device specific Flash programming algorithms</li>
</ul>
<p>A device will inherit the specifications from both the family and sub-family levels. Some properties are required to be unique. For example, the name of the svd file attribute of the <b>&lt;debug&gt;</b> property. Therefore, the svd file specified on the family level can be redefined by the attribute on the sub-family or device level. Information like the description and feature entries are concatenated, starting with the information from the family and sub-family level and finalizing with the information on the device level.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;package&gt;</div>
<div class="line">  ...</div>
<div class="line">  &lt;devices&gt;</div>
<div class="line">    &lt;!-- family level --&gt;</div>
<div class="line">    &lt;family Dfamily=<span class="stringliteral">&quot;STM32F2&quot;</span> Dvendor=<span class="stringliteral">&quot;STMicroelectronics:13&quot;</span>&gt;</div>
<div class="line">      &lt;processor Dcore=<span class="stringliteral">&quot;Cortex-M3&quot;</span> DcoreVersion=<span class="stringliteral">&quot;r2p1&quot;</span></div>
<div class="line">                 Dfpu=<span class="stringliteral">&quot;NO_FPU&quot;</span> Dmpu=<span class="stringliteral">&quot;MPU&quot;</span> Dendian=<span class="stringliteral">&quot;Little-endian&quot;</span> Dclock=<span class="stringliteral">&quot;120000000&quot;</span>/&gt;</div>
<div class="line"></div>
<div class="line">      &lt;compile   header=<span class="stringliteral">&quot;Device/Include/stm32f2xx.h&quot;</span> define=<span class="stringliteral">&quot;STM32F2XX&quot;</span>/&gt;</div>
<div class="line">      &lt;debug     svd=<span class="stringliteral">&quot;SVD/STM32F20x.svd&quot;</span>/&gt;</div>
<div class="line">      &lt;algorithm name=<span class="stringliteral">&quot;Flash/STM32F2xx_OPT.flm&quot;</span> start=<span class="stringliteral">&quot;0x1FFFC000&quot;</span> size=<span class="stringliteral">&quot;0x00000010&quot;</span> style=<span class="stringliteral">&quot;Keil&quot;</span>/&gt;</div>
<div class="line">      &lt;book      name=<span class="stringliteral">&quot;doc/STM32F2.PDF&quot;</span> title=<span class="stringliteral">&quot;STM32F2 Reference Manual&quot;</span>/&gt;</div>
<div class="line"></div>
<div class="line">      &lt;description&gt;</div>
<div class="line">        Arm 32-bit Cortex-M3 CPU based Microcontroller</div>
<div class="line">        - 120 MHz maximum frequency producing 150 DMIPS/1.25 DMIPS/MHz</div>
<div class="line">        - Memory Protection Unit</div>
<div class="line">        - Flexible <span class="keyword">static</span> memory controller (supports Compact Flash, SRAM, PSRAM, NOR, NAND memories)</div>
<div class="line">        - LCD parallel interface, 8080/6800 modes</div>
<div class="line">        - Clock, reset and supply management</div>
<div class="line">      &lt;/description&gt;</div>
<div class="line"></div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;Timer&quot;</span> n=<span class="stringliteral">&quot;10&quot;</span> m=<span class="stringliteral">&quot;32&quot;</span> name=<span class="stringliteral">&quot;General Purpose Timer with 60 MHz&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;Timer&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> m=<span class="stringliteral">&quot;16&quot;</span> name=<span class="stringliteral">&quot;Advanced Control Timer with 120 MHz&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;Timer&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> m=<span class="stringliteral">&quot;16&quot;</span> name=<span class="stringliteral">&quot;Basic Timer with 60 MHz&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;TimerOther&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;Independent Watchdog Timer&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;TimerOther&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> name=<span class="stringliteral">&quot;Window Watchdog Timer&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;DAC&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> m=<span class="stringliteral">&quot;12&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;SPI&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span> name=<span class="stringliteral">&quot;SPI Interface (two of them can be used as I2S)&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;I2C&quot;</span> n=<span class="stringliteral">&quot;3&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;USART&quot;</span> n=<span class="stringliteral">&quot;4&quot;</span> name=<span class="stringliteral">&quot;USART Interface up to 7.5 Mbit/s&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;UART&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span> name=<span class="stringliteral">&quot;UART Interface up to 3.75 Mbit/s&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;USBOTG&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span>  name=<span class="stringliteral">&quot;USB OTG (Full-Speed) with PHY and ULPI&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;USBOTG&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span>  name=<span class="stringliteral">&quot;USB OTG (High-Speed) with PHY and ULPI&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;CAN&quot;</span> n=<span class="stringliteral">&quot;2&quot;</span>  name=<span class="stringliteral">&quot;CAN Interface (2.0b Active)&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;SDIO&quot;</span> n=<span class="stringliteral">&quot;1&quot;</span> m=<span class="stringliteral">&quot;8&quot;</span> name=<span class="stringliteral">&quot;Supporting SD/MicroSD/MMC&quot;</span>/&gt;</div>
<div class="line">      &lt;feature type=<span class="stringliteral">&quot;VCC&quot;</span> n=<span class="stringliteral">&quot;1.8&quot;</span> m=<span class="stringliteral">&quot;3.6&quot;</span>/&gt;</div>
<div class="line"></div>
<div class="line">      &lt;!-- sub family level --&gt;</div>
<div class="line">      &lt;subFamily DsubFamily=<span class="stringliteral">&quot;128 Flash&quot;</span>&gt;</div>
<div class="line">        &lt;memory name=<span class="stringliteral">&quot;SRAM&quot;</span>  access=<span class="stringliteral">&quot;rwx&quot;</span> start=<span class="stringliteral">&quot;0x20000000&quot;</span> size=<span class="stringliteral">&quot;0x10000&quot;</span> <span class="keywordflow">default</span>=<span class="stringliteral">&quot;1&quot;</span>/&gt;</div>
<div class="line">        &lt;memory name=<span class="stringliteral">&quot;Flash&quot;</span> access=<span class="stringliteral">&quot;rx&quot;</span>  start=<span class="stringliteral">&quot;0x08000000&quot;</span> size=<span class="stringliteral">&quot;0x20000&quot;</span> startup=<span class="stringliteral">&quot;1&quot;</span> <span class="keywordflow">default</span>=<span class="stringliteral">&quot;1&quot;</span>/&gt;</div>
<div class="line">        </div>
<div class="line">        &lt;!-- device level --&gt;</div>
<div class="line">        &lt;device Dname=<span class="stringliteral">&quot;STM32F205RB&quot;</span>&gt;</div>
<div class="line">          &lt;feature type=<span class="stringliteral">&quot;IOs&quot;</span> n=<span class="stringliteral">&quot;51&quot;</span> name=<span class="stringliteral">&quot;Input and Output Ports&quot;</span>/&gt;</div>
<div class="line">          &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205RBT6&quot;</span>&gt;</div>
<div class="line">            &lt;feature type=<span class="stringliteral">&quot;QFP&quot;</span> count=<span class="stringliteral">&quot;64&quot;</span> name=<span class="stringliteral">&quot;LQFP 64 10x10x1.4&quot;</span> /&gt;</div>
<div class="line">            &lt;feature type=<span class="stringliteral">&quot;Temp&quot;</span> n=<span class="stringliteral">&quot;-40&quot;</span> m=<span class="stringliteral">&quot;85&quot;</span> name=<span class="stringliteral">&quot;Industrial Temperature Range&quot;</span>/&gt;</div>
<div class="line">          &lt;/variant&gt;</div>
<div class="line">          &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205RBT7&quot;</span>&gt;</div>
<div class="line">            &lt;feature type=<span class="stringliteral">&quot;QFP&quot;</span> count=<span class="stringliteral">&quot;64&quot;</span> name=<span class="stringliteral">&quot;LQFP 64 10x10x1.4&quot;</span> /&gt;</div>
<div class="line">            &lt;feature type=<span class="stringliteral">&quot;Temp&quot;</span> n=<span class="stringliteral">&quot;-40&quot;</span> m=<span class="stringliteral">&quot;105&quot;</span> name=<span class="stringliteral">&quot;Extended Temperature Range&quot;</span>/&gt;</div>
<div class="line">          &lt;/variant&gt;</div>
<div class="line">        &lt;/device&gt;</div>
<div class="line">                </div>
<div class="line">        &lt;device Dname=<span class="stringliteral">&quot;STM32F205VB&quot;</span>&gt;</div>
<div class="line">          &lt;feature type=<span class="stringliteral">&quot;IOs&quot;</span> n=<span class="stringliteral">&quot;82&quot;</span> name=<span class="stringliteral">&quot;Input and Output Ports&quot;</span>/&gt;</div>
<div class="line">          &lt;variant Dvariant=<span class="stringliteral">&quot;STM32F205VBT6&quot;</span>&gt;</div>
<div class="line">            &lt;feature type=<span class="stringliteral">&quot;QFP&quot;</span> count=<span class="stringliteral">&quot;100&quot;</span> name=<span class="stringliteral">&quot;LQFP 100 14x14x1.4&quot;</span> /&gt;</div>
<div class="line">            &lt;feature type=<span class="stringliteral">&quot;Temp&quot;</span> n=<span class="stringliteral">&quot;-40&quot;</span> m=<span class="stringliteral">&quot;85&quot;</span> name=<span class="stringliteral">&quot;Industrial Temperature Range&quot;</span>/&gt;</div>
<div class="line">          &lt;/variant&gt;</div>
<div class="line">        &lt;/device&gt;</div>
<div class="line">      &lt;/subFamily&gt;</div>
<div class="line">          </div>
<div class="line">    &lt;/family&gt;</div>
<div class="line">  &lt;/devices&gt;</div>
<div class="line">&lt;/package&gt;</div>
</div><!-- fragment --><p>&#160;</p>
<hr/>
<h1><a class="anchor" id="element_devices"></a>
/package/devices</h1>
<p>Group level containing device <a class="el" href="pdsc_family_pg.html">family</a> descriptions. A package can contain only one element <b>&lt;devices&gt;</b>. The group is not mandatory.</p>
<p><b>Example</b> </p>
<div class="fragment"><div class="line">&lt;package&gt;</div>
<div class="line">  ...</div>
<div class="line">  &lt;devices&gt;</div>
<div class="line">    ...</div>
<div class="line">  &lt;/devices&gt;</div>
<div class="line">  ...</div>
<div class="line">&lt;/package&gt;</div>
</div><!-- fragment --><p><br/>
 </p>
<table  class="cmtable" summary="Element: devices">
<tr>
<th>Parents </th><th colspan="3">Element Chain  </th></tr>
<tr>
<td><a class="el" href="pdsc_package_pg.html#element_package">package</a> </td><td colspan="3"><a class="el" href="pdsc_package_pg.html#element_package">/package</a>  </td></tr>
<tr>
<th>Child&#160;Elements </th><th>Description </th><th>Type </th><th>Occurrence  </th></tr>
<tr>
<td><a class="el" href="pdsc_family_pg.html#element_family">family</a> </td><td>Device family group. Define all properties that are in common to devices of a family. </td><td>complexType </td><td>1..*  </td></tr>
</table>
<p>&#160;</p>
<hr/>
 </div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="navelem"><a class="el" href="packFormat.html">Pack Description (*.pdsc) Format</a></li>
    <li class="footer">Generated on Wed Jul 10 2019 15:21:00 for CMSIS-Pack Version 1.6.0 by Arm Ltd. All rights reserved.
	<!--
    <a href="http://www.doxygen.org/index.html">
    <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6 
	-->
	</li>
  </ul>
</div>
</body>
</html>
